Adopt instinct-design flavor: Instinct Design System landing-page redesign - #133
Draft
AMD-melliott wants to merge 2 commits into
Draft
Adopt instinct-design flavor: Instinct Design System landing-page redesign#133AMD-melliott wants to merge 2 commits into
AMD-melliott wants to merge 2 commits into
Conversation
…e redesign Squashed redesign work developed on amd-tme/instinct-docs, merged forward onto current develop (includes the gpu-arch removal and Spur addition already on develop). - Cut over to the official instinct-design flavor from rocm-docs-core (superseding the earlier manual asset port). - Redesign the landing page and System Administrators subpages (bare-metal, cluster, co-tools, cloud, virtualization) around a shared icon-card component (`system-admin/_cards/*.md` MyST includes), replacing the old sphinx-design grid-item-card/img-top photography. - Add a collapsible primary sidebar with a working toggle, a sticky on-page rail, and default-open System Administrator groups. - Fix the dead `css/index.css` static-asset reference in conf.py's setup(). - Consolidate the separately-added Resources pages (Tools / Common Reference) into the redesign's existing landing-page sections, since their content was fully duplicated there. - Port forward new content added to develop in the interim (Spur, MI3XX Reference Design, AMD-DriveNets System Reference Architecture, a RoCE traffic-analysis blog card) into the new icon-card format.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation
Cut over instinct-docs to the official
instinct-designflavor shipped byrocm-docs-core, and redesign the landing page and System Administrators subpages around a shared, reusable icon-card component. This replaces the earlier manual asset port and the oldersphinx-designgrid-item-card/photography-based cards with something more consistent and easier to maintain.Technical Details
flavor: "instinct-design"(superseding the manually-vendored design-system assets from the original port).system-admin/_cards/*.md— reusable MyST{include}partials, one per tool/resource card — used across the landing page and all System Administrators subpages (bare-metal, cluster, co-tools, cloud, virtualization) instead of duplicating card markup per page.docs/_static/css/index.cssstatic-asset reference inconf.py'ssetup()(the realindex.csswas already loading correctly viahtml_css_files; theadd_css_filecall pointed at a path that never existed).docs/resources/{index,common-reference}.mdpages into the redesign's existing landing-page sections, since their content (Enterprise AI, Omnistat, CVS, AMD SMI, RVS, Instinct Micro-architecture, HIP C++, OpenMP, etc.) was fully duplicated there.rocm_docs_generate_llmsand the newrepository_url/use_repository_button/use_issues_button/use_download_buttontheme options already ondevelop.developsince this branch diverged — Spur, MI3XX Reference Design, AMD-DriveNets System Reference Architecture, and a RoCE traffic-analysis blog card — into the new icon-card format so nothing added upstream in the interim was lost.Test Plan
docs/resources/*pages.Submission Checklist